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Method for Converting Applications using Embedded SQL for Database Access to Portable ODBC 
Database Access 
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Idea of disclosure 



^gjielatioaal database as a persistent data stor¥! These applications are 

Each database 




1. Describe your invention, stating the problem solved (if appropriate), and indicating the advantages of 
using the invention, 
Cunrently many applications use 3_ 
often written4Jsing_embedded 

SQL,lo support a single database manageme such as^Oracle's Pro 
manager has a slightly aifferehTimplementatioh of the 

embedded SQL language used within an appiication program. This poses a problem when there is a^ ^ 
need to make the application wortc with one or more of the other relational database management^/ 
systems. 

Our invention addresses this problem by converting the appJicaUons written using embedded SQL such 
that the platform independent_ODe.Cjaterface is used throughouTfhe application instead of the 
embedded SQL. ODBC is portable across database mmagecnent s^^^^ with little or no change to the 
application." ' ' 

The major advantage of our application is that the tra nslation from embedded SQL to ODj C isportable 
aemss^the-datab ase managemen_t_ systems. It resultsin a singla^eto^aMl^ that js po^rtable, 

ra ther than a different s gtoLogdeJox^ach,^^ 

2. How does the invention solve the problem or achieve an advantage,(a description of "the invention", 
including figures inline as appropriate)? / / 

Our conversion tool consists of two parts, the Source Code Trans lator, and the Database Ac cess 
Library of ODBC functions. . 

r-\<^^'' 

The Source Code Translatgi>-^x^ \ 

DB2Trans is a tool-tHat is used to crea te * . c files ^^itable . 
fox:access to anODB^C ena bled datab^se-jpSfiSSen ^^ V 
DB ^l^rans'^lviirbe written usin^^ Java^ecause or~ttie rich ^ 
;^tring manipulation class library in theiaHK. DB2.Trans^ will pa rse 
j*-raql-^les , coAtaining Oracle Pro C embedded SQL syntax, andT 



% 



produce code thaF~w]^n compiled will ma ke proper calls to the 
DB_A ccess m odule . 

\ 'The following classes are defined: 



Smartln : 



^^ ^.tu . This manages th^hiput file, whic]i_will be the Oracle 

* . sjqLfile_cont5Limn^. Jhe_emb^ . A "method 

should be added, -called readSQLstmtV thaFshould read one or more 
lines' until the Jj^n- .encou^t^^ This is because most EXEC SQL 
statements span multipleTihes vnthin^jthe_e4itor (CR/LFs embedded) 
but DB?3>Riis_wi11 jnst f^pfll with and^jiarse the EXEC SOL ; 
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statement as one entity. There should be one public data member 
which is the .Igtri ng inputStatem ent' , 'InputStatement' will be 
passed to St atement _class for parsing and proc essing. 
° SmartOut: This manages the output file, which will be the *.c 
fil e incorpor ating busine ss logic with calls to DBAccess for 
access to a relational database via ^ ODB C . The SmartOut class 
from PVSim should be reused. There should be one public data 
member which is the 'String outputStatement' . There should b ^ 
methods within SnigirtOut- to add tg>Yt tn this fitatpmpnt b ased^ on 
decisi ons made in Statement^ lass . The data member ' 
outputStatement is what is written to t he *.c file ^o rjater ' 
com pilation ^{ 

Statement: This is where the bulk of the logic will reside. \j 
hods of theNqlasses include: 

Determine type^f SQL statement 
Add headei^ file 





Process /^atement 



Process nonSQL statements 



\ 



roce&sBBginDeclare 
process Connect^ 
fuflfoll 



pTTC^S'&CtymiSiflfo^llback 
processSelectlnto 
processPrepare 
process'DeclareCursor 
processOpenCursor 
processCloseCursor 
processFetch 

processInsertUpdateDelete 
processExecute 
processNonTranslatedSQL" 
parseSQLStatement 
BuildHostVarStructure 
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J Make calls to SmartOut to build result rfring into,^-H^- 

.f-liS-' outputStatement ^ .^^aS ' V/- 

DBAccess: 

DBAccess .c will-b.e, a single standa rd^NSI. C module w ith 
mu.ltip.le..f3arLCtions . All DB2 CLI calls will be conxained within 
this module. 

The environment and database connection handles will be reused 
throughout the life of the executable, s tatement handles will be 
allocated /free4_pfir_slatement. ~ 

sqlcode -_a BAconn (Suse r , £pw) ; ..^^ 

' ThiT function is used to allocate handles and make the initial 
connection to ODBC. 



Functions Definition and Logic 
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sqlcode = DBAtermO ; 

This function is used to make CLI calls to free connec tion 
re^ouiLces, after this processing the ^executable wil l no longer be 
co.nnected_.tq the datebase and no furtEer ~uDBC calls can b e made. 
Tliis function is ca^^^^^ from DBAiiowlivlieh release = 1, yes. 



sqlcode = DBAuow(int statement type, int release) ; 

This function will just be a switch statement on the 
parameter statement type. Obtain the environment and database 
connection handles, SQL^COMMIT and SQL_ROLLBACK are used 
depending on the request. Issue the ODBC call SQLTransact() . If 
Release = 1 (Yes) then calL-JUBAtenn which will make ODBC calls 
to^^freeconnectig^^ after this processing the executable \ r? 

will no longer be connected to the database and no further ODB C Vl A 
calls can be made . / f ^ \\ 

sqj^ode = DBASelectIntc/(&stint J fistartinaaddress of 

:ructures_contaijLin.g_d:a^a^,.,^Ps5, l^e turnfed~hps t 
iriables, and indicator v ariab les^ \ j 

'This function is used 'ToTproceis" SQL SELECTN^tatements . 

The parser generates a statement in which valt^bk have been 
substituted for all of the host variable required for processing the 

statement, for example, the value of CARTREFE is Known 
beforg^the-parsing begins and is substituted into the SQL Spring that 

^will be processed. ______ / , 

EXAMPLE: 'Sg^CT'eEMPRESA, CARTREFE / XXXXXX ^'ROM 



T6198000 WHERE 




RTREFE = MD|000000000000r 



sqlcode =^PBAPfepareDeclar6 ( 6s tmt) 

This fuiictioh is used to process SQL DEC LARE and P REPARE 
yv^tajements. 

The parser generates a statement in which values have been 
substituted for all of the host variable ^quired for_ process ing the 

statement, for example, the value^otjCKKin^^ known 
before tKe parsing begins and is substituted into the SQL string that 

will be processed. 

EXAMPLE: SELECT CEMPRESA, CARTREFE, XXXXXX FROM 
T6198000 WHERE CARTREFE = '00000000000001' \ 



sqlcode = DBAFetch (fihstmt, 



6s tar ting address of 
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structures containing data types, returned host 
variables, and indicator variables) 
/* This statement is called when an EXEC SQL FETCH is 
encountered. */ 



sqlcode = DBAEndSelect (fihstmt) ; 

/* This statement is called when an EXEC SQL CLOSE CURSOR is 
encountered. */ 



sqlcode = DBAupdate (fistatement) 

This call will support searched (not cursor related) 
INSERT / UPD AT E / D ELETE . 

The parser generates a statement in which values have been 
substituted for all of the host variable required for processing the 

statement, for example, the value of CARTREFE is known 
before the parsing begins and is substituted into the SQL string that 

will be processed. 

EXAMPLE: SELECT CEMPRESA, CARTREFE, XXXXXX FROM 
T6198000 WHERE CARTREFE = '00000000000001* 



Supporting Code Design 



Host Variable Definition Structuri 




-A-structure wilt^Beused to contain information needed to 



process and return data for each host variable used. The structure 
is defined in db2da.h. The structure will be dynamically allocated 
from within the processed files, with an^jnstance of the structure 
pj er host va riable. A siiigle_variable coiitainiligT Ei_ad^^ the 
start-^o£_l he list of repeating ^structures will be^assed'to tHe 
appropriate DB Access functions. 
^^TlB2Trans^^^^^th^^^o]^^ 

WxeiL^,:^^^^^3^Gm^^J^ is reached,. tLulld^a^Jiash 
table {(Keyworo^^ name) for e ach h ostjariable 

contdmngTTsg^a^^iin^^ If a new definition of the host 

variable is encountered, the old definition is replaced. 
0 When an SQL statement is encountered, pars e the host variables 
and ^eeg ^count of the number. ' " 

° Host_:s:ajdabIes'~afe^ways processed by numeric order, from 
left to write. 

^ void^phostvarlist = malloc( number of host variables * "7 
sizeof (hostvarstruct) ) ^ J 

^ Pass into DB Access hostvar, / 

The structure definition is: 
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struct hostvarstruct { 
intjiatatj[pe; 
intlgagth; 
void *phvlocation; 
void *pindvar location; 

}; 



Header file dj:>2da,h 

Contents^re as follows: 
sqlcode 

pHenv (contain environment handle, reused across exe life) 
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dbc (contain database connection handle, reused across exe^^^jj^""^ f^\^ 



sqlca structure 
hostvarstruct 

#defines for SQL datatjrpes 
#define for schema name (like 'U604') 
#define for CLI database name (like 'storeflow32') 






Runtime Configuration 

It is not expected that DBAccess will need any runtime 
co nfigura tion files. All attributes should be bound at _buiLd time. 
TheOnSir?nferface itself can be configurg ^to estabhsh mo st qf ^ 



the Jcey rU-Atigie att ributes 
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